Get billing balance
Get the live shared-pool balance and agent scopes, or the effective balance for agent_slug with fallback to the shared pool.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Query Parameters
Agent scope identifier. Null is the customer's shared pool.
1 - 128"support"
Response
Agent scope identifier. Null is the customer's shared pool.
"support"
Billing mode.
- wallet: Charges a monetary wallet.
- credits: Consumes a credit balance.
- windows: Meters weighted units against rolling allowances.
wallet, credits, windows "wallet"
Current balance in the accompanying denomination.
Whether spending is disabled for this billing scope.
false
Billing rules resolved for this scope, or null when unconfigured.
null
Current state of every rolling allowance window, or null outside windows mode.
Credit balance and product details, or null outside credits mode.
null
Overage policy, current boundary status and unsettled monetary balance; null in wallet mode.
Last settled at, as a UTC ISO 8601 timestamp. Null when unavailable.
"2026-09-02T00:00:00Z"
Agent scopes with their own policy or consumption history.

